home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / mkaf.z / mkaf
Encoding:
Text File  |  2002-10-03  |  6.2 KB  |  133 lines
  1.  
  2.  
  3.  
  4. MMMMKKKKAAAAFFFF((((1111))))                                                                MMMMKKKKAAAAFFFF((((1111))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      mmmmkkkkaaaaffff - create a Performance Co-Pilot archive folio
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      $$$$PPPPCCCCPPPP____BBBBIIIINNNNAAAADDDDMMMM____DDDDIIIIRRRR////mmmmkkkkaaaaffff [_f_i_n_d_o_p_t_s] _f_i_l_e_n_a_m_e ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      A collection of one or more Performance Co-Pilot (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1))
  16.      archive logs may be combined with mmmmkkkkaaaaffff to produce a PCP archive folio and
  17.      the associated archive folio control file.  Some PCP tools use mmmmkkkkaaaaffff to
  18.      create archive folios, e.g.  the ``record'' facility in the ppppmmmmcccchhhhaaaarrrrtttt(1),
  19.      ppppmmmmvvvviiiieeeewwww(1) and oooovvvviiiieeeewwww(1) tools, to facilitate playback with ppppmmmmaaaaffffmmmm(1).
  20.  
  21.      mmmmkkkkaaaaffff processes each _f_i_l_e_n_a_m_e argument, and if this is a component file
  22.      from a PCP archive that archive is added to the folio.
  23.  
  24.      If _f_i_l_e_n_a_m_e is a directory, then this is searched recursively using
  25.      ffffiiiinnnndddd(1).  Any _f_i_l_e_n_a_m_e argument beginning with a ``-'' is assumed to be a
  26.      ffffiiiinnnndddd(1) command line option (_f_i_n_d_o_p_t_s); the default is ----ffffoooolllllllloooowwww if no
  27.      _f_i_n_d_o_p_t_s are specified.
  28.  
  29.      The first named archive in the folio is assumed to be associated with the
  30.      default host for any tool that tries to replay multiple archives from the
  31.      folio.
  32.  
  33.      The folio control file is written to standard output, and has the
  34.      following format.
  35.  
  36.      1. The first line contains the word PPPPCCCCPPPPFFFFoooolllliiiioooo.
  37.  
  38.      2. The second line contains the tag VVVVeeeerrrrssssiiiioooonnnn:::: followed by the format
  39.         version number (currently 1).
  40.  
  41.      3. For subsequent lines, blank lines and lines beginning with ``#'' are
  42.         ignored.
  43.  
  44.      4. The line beginning with the tag CCCCrrrreeeeaaaatttteeeedddd:::: documents where and when the
  45.         folio was created.
  46.  
  47.      5. The line beginning with the tag CCCCrrrreeeeaaaattttoooorrrr:::: identifies the tool which
  48.         created the folio (and is assumed to know how to replay the archive
  49.         folio).  If present, the second argument is the name of a
  50.         configuration file that the creator tool could use to replay the
  51.         archive folio, e.g. with the rrrreeeeppppllllaaaayyyy command for ppppmmmmaaaaffffmmmm(1).  In the case
  52.         of mmmmkkkkaaaaffff (unlike ppppmmmmcccchhhhaaaarrrrtttt(1) or ppppmmmmvvvviiiieeeewwww(1)) there is no knowledge of the
  53.         contents of the archives, so the ``creator'' cannot replay the
  54.         archive, however ppppmmmmcccchhhhaaaarrrrtttt(1) is able to replay any archive, and so this
  55.         tool is identified as the CCCCrrrreeeeaaaattttoooorrrr:::: for archive folios created by
  56.         mmmmkkkkaaaaffff(1).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. MMMMKKKKAAAAFFFF((((1111))))                                                                MMMMKKKKAAAAFFFF((((1111))))
  71.  
  72.  
  73.  
  74.      6. This is then followed by one or more lines beginning with the tag
  75.         AAAArrrrcccchhhhiiiivvvveeee:::: followed by the hostname and base name of the archive.
  76.  
  77.      For example
  78.           $ mkaf mydir/gonzo
  79.      might produce the following folio control file.
  80.  
  81.      PCPFolio
  82.      Version: 1
  83.      # use pmafm(1) to process this PCP archive folio
  84.      #
  85.      Created: on gonzo at Tue Jul  2 03:35:54 EST 1996
  86.      Creator: pmchart
  87.      #               Host                    Basename
  88.      #
  89.      Archive:        gonzo                   mydir/gonzo/960627
  90.      Archive:        gonzo                   mydir/gonzo/960628
  91.      Archive:        gonzo                   mydir/gonzo/960629
  92.      Archive:        gonzo                   mydir/gonzo/960630
  93.      Archive:        gonzo                   mydir/gonzo/960701
  94.      Archive:        gonzo                   mydir/gonzo/960701.00.10
  95.      Archive:        gonzo                   mydir/gonzo/960701.05.25
  96.      Archive:        gonzo                   mydir/gonzo/960702.00.10
  97.  
  98. PPPPCCCCPPPP EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
  99.      Environment variables with the prefix PPPPCCCCPPPP____ are used to parameterize the
  100.      file and directory names used by PCP.  On each installation, the file
  101.      /_e_t_c/_p_c_p._c_o_n_f contains the local values for these variables.  The
  102.      $$$$PPPPCCCCPPPP____CCCCOOOONNNNFFFF variable may be used to specify an alternative configuration
  103.      file, as described in ppppccccpppp....ccccoooonnnnffff(4).
  104.  
  105. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  106.      ffffiiiinnnndddd(1), oooovvvviiiieeeewwww(1), PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmaaaaffffmmmm(1), ppppmmmmcccchhhhaaaarrrrtttt(1), ppppmmmmvvvviiiieeeewwww(1),
  107.      ppppccccpppp....ccccoooonnnnffff(4) and ppppccccpppp....eeeennnnvvvv(4).
  108.  
  109. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  110.      Some informational messages, warnings and pathological conditions are
  111.      reported on standard error.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.